home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
system
/
watch102.zip
/
WATCH102.DOC
< prev
next >
Wrap
Text File
|
1990-11-11
|
19KB
|
521 lines
┌───────────────────────────────────────────────────────┐
│ │
│ │
│ W A T C H . E X E │
│ │
│ and │
│ │
│ W A T C H C . E X E │
│ │
│ │
│ The Mini Program Execution Profiler │
│ │
│ Documentation │
│ │
│ Compliments of: DSE Software Publishing │
│ │
│ ╔═══════════════════════════════════╗ │
│ ║ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ ║ │
│ ║ ▀▀▀ ▀ ▀▀ ▀▀ ▀▀▀ ▀▀ ║ │
│ ║ ▀▀▀ ▀ ▀▀ ▀ ▀▀▀ ▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀ ▀▀▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀▀ ▀▀▀▀▀▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀▀ ▀▀▀ ▀ ║ │
│ ║ ▀▀▀ ▀▀ ▀▀ ▀▀▀ ║ │
│ ║ ▀▀▀ ▀ ▀ ▀▀ ▀▀▀ ▀ ║ │
│ ║ ▀▀▀ ▀ ▀▀ ▀▀ ▀▀▀ ▀▀ ║ │
│ ║ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ ║ │
│ ╚═══════════════════════════════════╝ │
│ │
│ DSE Software Publishing │
│ P.O. Box 96 │
│ Willits, CA 95490-0096 │
│ (707) 459-4358 │
│ │
└───────────────────────────────────────────────────────┘
Microsoft(R), MS-DOS(R), and QuickBASIC(R) are registered
trademarks belonging to Microsoft Corporation. IBM(R) and PC-
DOS(R) are registered trademarks belonging to International
Business Machines. TesSeRact(tm) is a trademark of TesSeRact
Development Team. ProWindows(tm) and HyperNotes(tm) are
trademarks of DSE Software Publishing.
INTRODUCTION
Thank you for downloading a copy of the WATCH utilities, our
"Mini Program Execution Profilers".
The WATCH utilities are simple utilities that allow you to
track the exact execution time of a program and the manner in
which it returned control back to DOS. But whatever you use
the WATCH utilities for, keep this in mind:
WARRANTY
This product is sold "AS IS" and DSE Software Publishing
specifically disclaims all warranties, expressed or implied,
including but not limited to implied warranties of
merchantability and fitness for a particular purpose. In no
event shall DSE Software Publishing and/or the author Daniel
P. Stasinski be liable for any loss of profit or any other
commercial damage, including but not limited to special,
incidental, consequential or other damages.
In layman's terms: "If lightening strikes your wife's cat
while you are using WATCH, it is purely coincidence, and we
really don't care".
AND FURTHER MORE
DSE Software Publishing has placed this utility into the
Public Domain. You may use it, give it away, sell it for up
to $100,000 per copy, or dance on it under a full moon in
July. All we ask is that you don't remove our name from it.
If you have any questions or comments about this program,
feel free to contact us at any time. We can be reached in
the following ways:
1). Fnet (FoReM) messages can be addressed to "PROWINDOWS"
at Node #387 (Ukiah, California), or through "The MS-
DOS(R) Programmer's Conference" available on CrossNet
(Conference Code: 20387).
2). BBS Support at (707) 463-2418. Messages can be
addressed to "PROWINDOWS".
3). GE-Mail (GEnie) messages can be addressed to
"DSE.SOFTWARE".
4). Voice support is available Monday through Friday, 12:00
PM to 5:00 PM (Pacific) at (707) 459-4358.
5). US Mail is by far the slowest but may be addressed to:
DSE Software Publishing
P.O. Box 96
Willits, CA 95490-0096
BACKGROUND
The WATCH utilities (WATCH.EXE and WATCHC.EXE) are used to
monitor the total execution time of a program. One version
will also return the test program's termination code, and the
manner in which it was terminated (no, these aren't the same
thing).
Both WATCH utilities were written in 100% assembly language.
Unlike a couple if similar utilities (Written in C), the
WATCH utilities dynamically shrink themselves just prior to
running.
WATCH.EXE
WATCH.EXE executes a program directly, and does not require a
secondary DOS shell. It is able to run in less than 2980
bytes of RAM. It's only drawback is that it does not seem to
be able to process some standard DOS utilities (ie, XCOPY,
FORMAT, and others). It may also not work with utilities
that require wildcards (* or ?). This is due to the way
these utilities parse the DOS command line.
When correctly used, WATCH.EXE will return the following
information:
Command : PROGRAM.EXE parameters
Start Date : MM/DD/YY
Start Time : HH:MM:SS.ms
Stop Time : HH:MM:SS.ms
Elapsed Time : HH:MM:SS.ms
Termination : Normal | Device Error | TSR | Ctrl-Break
Return Code : 0 to 255
WATCHC.EXE
WATCHC.EXE executes a program by loading a secondary DOS
shell, and executing the test program through it. It's
drawbacks are that the 2nd COMMAND.COM uses additional
memory (around 4000 bytes more). It's major drawback is that
the time it takes to load the 2nd copy of COMMAND.COM may
somewhat taint the "Elapsed time" results. This version
will, however, work will all DOS utilities.
When correctly used, WATCHC.EXE will return the following
information:
Command : PROGRAM.EXE parameters
Start Date : MM/DD/YY
Start Time : HH:MM:SS.ms